home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / standard / pwlcurve.z / pwlcurve
Encoding:
Text File  |  2002-10-03  |  4.6 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ppppwwwwllllccccuuuurrrrvvvveeee((((3333GGGG))))                                                      ppppwwwwllllccccuuuurrrrvvvveeee((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppwwwwllllccccuuuurrrrvvvveeee - describes a piecewise linear trimming curve for NURBS surfaces
  10.  
  11. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      vvvvooooiiiidddd ppppwwwwllllccccuuuurrrrvvvveeee((((nnnn,,,, ddddaaaattttaaaa____aaaarrrrrrrraaaayyyy,,,, bbbbyyyytttteeee____ssssiiiizzzzeeee,,,, ttttyyyyppppeeee))))
  13.      lllloooonnnngggg nnnn,,,, bbbbyyyytttteeee____ssssiiiizzzzeeee,,,, ttttyyyyppppeeee;;;;
  14.      ddddoooouuuubbbblllleeee ****ddddaaaattttaaaa____aaaarrrrrrrraaaayyyy;;;;
  15.  
  16. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  17.      _n            expects the number of points on the curve
  18.  
  19.      _d_a_t_a__a_r_r_a_y   expects an array containing the curve points
  20.  
  21.      _b_y_t_e__s_i_z_e    expects the offset (in bytes) between points on the curve
  22.  
  23.      _t_y_p_e         expects a value indicating the point type.  Currently, the
  24.                   only data type supported is N_ST, corresponding to pairs of
  25.                   s-t coordinates.  The offset parameter is used in case the
  26.                   curve points are part of an array of larger structure
  27.                   elements. ppppwwwwllllccccuuuurrrrvvvveeee searches for the _n-th coordinate pair
  28.                   beginning at _d_a_t_a__a_r_r_a_y + _n * _b_y_t_e__s_i_z_e.
  29.  
  30. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  31.      Use ppppwwwwllllccccuuuurrrrvvvveeee to describe a piecewise linear curve.  A piecewise linear
  32.      curve consists of a list of pairs of coordinates of points in the
  33.      parameter space for the NURBS surface.  These points are connected
  34.      together with straight lines to form a path.  If a piecewise linear curve
  35.      is an approximation to a real curve, the points should be close enough
  36.      together that the resulting path will appear curved at the resolution
  37.      used in the application.
  38.  
  39.      You use piecewise linear curves within trimming loop definitions. A
  40.      trimming loop definition is a set of oriented curve commands that
  41.      describe a closed loop.  To mark the beginning of a trimming loop
  42.      definition, use the bbbbggggnnnnttttrrrriiiimmmm command.  To mark the end of a trimming loop
  43.      definition, use an eeeennnnddddttttrrrriiiimmmm command.
  44.  
  45.      You use trimming loop definitions within NURBS surface definitions (see
  46.      bbbbggggnnnnssssuuuurrrrffffaaaacccceeee). The trimming loops are closed curves that the system uses to
  47.      set the boundaries of a NURBS surface. You can describe a trimming loop
  48.      by using a series of piecewise linear curves or NURBS curves (see
  49.      nnnnuuuurrrrbbbbssssccccuuuurrrrvvvveeee), or both.
  50.  
  51.      When the system needs to decide which part of a NURBS surface you want it
  52.      to display, it displays the region of the NURBS surface that is to the
  53.      left of the trimming curves as the parameter increases. Thus, for a
  54.      counter-clockwise oriented trimming curve, the displayed region of the
  55.      NURBS surface is the region inside the curve.  For a clockwise oriented
  56.      trimming curve, the displayed region of the NURBS surface is the region
  57.      outside the curve.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ppppwwwwllllccccuuuurrrrvvvveeee((((3333GGGG))))                                                      ppppwwwwllllccccuuuurrrrvvvveeee((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      See the _G_r_a_p_h_i_c_s _L_i_b_r_a_r_y _P_r_o_g_r_a_m_m_i_n_g _G_u_i_d_e for a mathematical description
  75.      of a NURBS curve.
  76.  
  77. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  78.      bgnsurface, nurbssurface, bgntrim, nurbscurve, getnurbsproperty,
  79.      setnurbsproperty
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.